home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / src / linux-headers-2.6.28-15 / include / linux / videodev2.h < prev    next >
Encoding:
C/C++ Source or Header  |  2008-12-24  |  52.2 KB  |  1,475 lines
  1. /*
  2.  *  Video for Linux Two header file
  3.  *
  4.  *  Copyright (C) 1999-2007 the contributors
  5.  *
  6.  *  This program is free software; you can redistribute it and/or modify
  7.  *  it under the terms of the GNU General Public License as published by
  8.  *  the Free Software Foundation; either version 2 of the License, or
  9.  *  (at your option) any later version.
  10.  *
  11.  *  This program is distributed in the hope that it will be useful,
  12.  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13.  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14.  *  GNU General Public License for more details.
  15.  *
  16.  *  Alternatively you can redistribute this file under the terms of the
  17.  *  BSD license as stated below:
  18.  *
  19.  *  Redistribution and use in source and binary forms, with or without
  20.  *  modification, are permitted provided that the following conditions
  21.  *  are met:
  22.  *  1. Redistributions of source code must retain the above copyright
  23.  *     notice, this list of conditions and the following disclaimer.
  24.  *  2. Redistributions in binary form must reproduce the above copyright
  25.  *     notice, this list of conditions and the following disclaimer in
  26.  *     the documentation and/or other materials provided with the
  27.  *     distribution.
  28.  *  3. The names of its contributors may not be used to endorse or promote
  29.  *     products derived from this software without specific prior written
  30.  *     permission.
  31.  *
  32.  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  33.  *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  34.  *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  35.  *  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  36.  *  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  37.  *  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
  38.  *  TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  39.  *  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  40.  *  LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  41.  *  NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  42.  *  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  43.  *
  44.  *    Header file for v4l or V4L2 drivers and applications
  45.  * with public API.
  46.  * All kernel-specific stuff were moved to media/v4l2-dev.h, so
  47.  * no #if __KERNEL tests are allowed here
  48.  *
  49.  *    See http://linuxtv.org for more info
  50.  *
  51.  *    Author: Bill Dirks <bill@thedirks.org>
  52.  *        Justin Schoeman
  53.  *              Hans Verkuil <hverkuil@xs4all.nl>
  54.  *        et al.
  55.  */
  56. #ifndef __LINUX_VIDEODEV2_H
  57. #define __LINUX_VIDEODEV2_H
  58.  
  59. #ifdef __KERNEL__
  60. #include <linux/time.h>     /* need struct timeval */
  61. #else
  62. #include <sys/time.h>
  63. #endif
  64. #include <linux/compiler.h>
  65. #include <linux/ioctl.h>
  66. #include <linux/types.h>
  67.  
  68. /*
  69.  * Common stuff for both V4L1 and V4L2
  70.  * Moved from videodev.h
  71.  */
  72. #define VIDEO_MAX_FRAME               32
  73.  
  74. #ifndef __KERNEL__
  75.  
  76. /* These defines are V4L1 specific and should not be used with the V4L2 API!
  77.    They will be removed from this header in the future. */
  78.  
  79. #define VID_TYPE_CAPTURE    1    /* Can capture */
  80. #define VID_TYPE_TUNER        2    /* Can tune */
  81. #define VID_TYPE_TELETEXT    4    /* Does teletext */
  82. #define VID_TYPE_OVERLAY    8    /* Overlay onto frame buffer */
  83. #define VID_TYPE_CHROMAKEY    16    /* Overlay by chromakey */
  84. #define VID_TYPE_CLIPPING    32    /* Can clip */
  85. #define VID_TYPE_FRAMERAM    64    /* Uses the frame buffer memory */
  86. #define VID_TYPE_SCALES        128    /* Scalable */
  87. #define VID_TYPE_MONOCHROME    256    /* Monochrome only */
  88. #define VID_TYPE_SUBCAPTURE    512    /* Can capture subareas of the image */
  89. #define VID_TYPE_MPEG_DECODER    1024    /* Can decode MPEG streams */
  90. #define VID_TYPE_MPEG_ENCODER    2048    /* Can encode MPEG streams */
  91. #define VID_TYPE_MJPEG_DECODER    4096    /* Can decode MJPEG streams */
  92. #define VID_TYPE_MJPEG_ENCODER    8192    /* Can encode MJPEG streams */
  93. #endif
  94.  
  95. /*
  96.  *    M I S C E L L A N E O U S
  97.  */
  98.  
  99. /*  Four-character-code (FOURCC) */
  100. #define v4l2_fourcc(a, b, c, d)\
  101.     ((__u32)(a) | ((__u32)(b) << 8) | ((__u32)(c) << 16) | ((__u32)(d) << 24))
  102.  
  103. /*
  104.  *    E N U M S
  105.  */
  106. enum v4l2_field {
  107.     V4L2_FIELD_ANY           = 0, /* driver can choose from none,
  108.                      top, bottom, interlaced
  109.                      depending on whatever it thinks
  110.                      is approximate ... */
  111.     V4L2_FIELD_NONE          = 1, /* this device has no fields ... */
  112.     V4L2_FIELD_TOP           = 2, /* top field only */
  113.     V4L2_FIELD_BOTTOM        = 3, /* bottom field only */
  114.     V4L2_FIELD_INTERLACED    = 4, /* both fields interlaced */
  115.     V4L2_FIELD_SEQ_TB        = 5, /* both fields sequential into one
  116.                      buffer, top-bottom order */
  117.     V4L2_FIELD_SEQ_BT        = 6, /* same as above + bottom-top order */
  118.     V4L2_FIELD_ALTERNATE     = 7, /* both fields alternating into
  119.                      separate buffers */
  120.     V4L2_FIELD_INTERLACED_TB = 8, /* both fields interlaced, top field
  121.                      first and the top field is
  122.                      transmitted first */
  123.     V4L2_FIELD_INTERLACED_BT = 9, /* both fields interlaced, top field
  124.                      first and the bottom field is
  125.                      transmitted first */
  126. };
  127. #define V4L2_FIELD_HAS_TOP(field)    \
  128.     ((field) == V4L2_FIELD_TOP     ||\
  129.      (field) == V4L2_FIELD_INTERLACED ||\
  130.      (field) == V4L2_FIELD_INTERLACED_TB ||\
  131.      (field) == V4L2_FIELD_INTERLACED_BT ||\
  132.      (field) == V4L2_FIELD_SEQ_TB    ||\
  133.      (field) == V4L2_FIELD_SEQ_BT)
  134. #define V4L2_FIELD_HAS_BOTTOM(field)    \
  135.     ((field) == V4L2_FIELD_BOTTOM     ||\
  136.      (field) == V4L2_FIELD_INTERLACED ||\
  137.      (field) == V4L2_FIELD_INTERLACED_TB ||\
  138.      (field) == V4L2_FIELD_INTERLACED_BT ||\
  139.      (field) == V4L2_FIELD_SEQ_TB    ||\
  140.      (field) == V4L2_FIELD_SEQ_BT)
  141. #define V4L2_FIELD_HAS_BOTH(field)    \
  142.     ((field) == V4L2_FIELD_INTERLACED ||\
  143.      (field) == V4L2_FIELD_INTERLACED_TB ||\
  144.      (field) == V4L2_FIELD_INTERLACED_BT ||\
  145.      (field) == V4L2_FIELD_SEQ_TB ||\
  146.      (field) == V4L2_FIELD_SEQ_BT)
  147.  
  148. enum v4l2_buf_type {
  149.     V4L2_BUF_TYPE_VIDEO_CAPTURE        = 1,
  150.     V4L2_BUF_TYPE_VIDEO_OUTPUT         = 2,
  151.     V4L2_BUF_TYPE_VIDEO_OVERLAY        = 3,
  152.     V4L2_BUF_TYPE_VBI_CAPTURE          = 4,
  153.     V4L2_BUF_TYPE_VBI_OUTPUT           = 5,
  154.     V4L2_BUF_TYPE_SLICED_VBI_CAPTURE   = 6,
  155.     V4L2_BUF_TYPE_SLICED_VBI_OUTPUT    = 7,
  156. #if 1
  157.     /* Experimental */
  158.     V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY = 8,
  159. #endif
  160.     V4L2_BUF_TYPE_PRIVATE              = 0x80,
  161. };
  162.  
  163. enum v4l2_ctrl_type {
  164.     V4L2_CTRL_TYPE_INTEGER         = 1,
  165.     V4L2_CTRL_TYPE_BOOLEAN         = 2,
  166.     V4L2_CTRL_TYPE_MENU         = 3,
  167.     V4L2_CTRL_TYPE_BUTTON         = 4,
  168.     V4L2_CTRL_TYPE_INTEGER64     = 5,
  169.     V4L2_CTRL_TYPE_CTRL_CLASS    = 6,
  170. };
  171.  
  172. enum v4l2_tuner_type {
  173.     V4L2_TUNER_RADIO         = 1,
  174.     V4L2_TUNER_ANALOG_TV         = 2,
  175.     V4L2_TUNER_DIGITAL_TV         = 3,
  176. };
  177.  
  178. enum v4l2_memory {
  179.     V4L2_MEMORY_MMAP             = 1,
  180.     V4L2_MEMORY_USERPTR          = 2,
  181.     V4L2_MEMORY_OVERLAY          = 3,
  182. };
  183.  
  184. /* see also http://vektor.theorem.ca/graphics/ycbcr/ */
  185. enum v4l2_colorspace {
  186.     /* ITU-R 601 -- broadcast NTSC/PAL */
  187.     V4L2_COLORSPACE_SMPTE170M     = 1,
  188.  
  189.     /* 1125-Line (US) HDTV */
  190.     V4L2_COLORSPACE_SMPTE240M     = 2,
  191.  
  192.     /* HD and modern captures. */
  193.     V4L2_COLORSPACE_REC709        = 3,
  194.  
  195.     /* broken BT878 extents (601, luma range 16-253 instead of 16-235) */
  196.     V4L2_COLORSPACE_BT878         = 4,
  197.  
  198.     /* These should be useful.  Assume 601 extents. */
  199.     V4L2_COLORSPACE_470_SYSTEM_M  = 5,
  200.     V4L2_COLORSPACE_470_SYSTEM_BG = 6,
  201.  
  202.     /* I know there will be cameras that send this.  So, this is
  203.      * unspecified chromaticities and full 0-255 on each of the
  204.      * Y'CbCr components
  205.      */
  206.     V4L2_COLORSPACE_JPEG          = 7,
  207.  
  208.     /* For RGB colourspaces, this is probably a good start. */
  209.     V4L2_COLORSPACE_SRGB          = 8,
  210. };
  211.  
  212. enum v4l2_priority {
  213.     V4L2_PRIORITY_UNSET       = 0,  /* not initialized */
  214.     V4L2_PRIORITY_BACKGROUND  = 1,
  215.     V4L2_PRIORITY_INTERACTIVE = 2,
  216.     V4L2_PRIORITY_RECORD      = 3,
  217.     V4L2_PRIORITY_DEFAULT     = V4L2_PRIORITY_INTERACTIVE,
  218. };
  219.  
  220. struct v4l2_rect {
  221.     __s32   left;
  222.     __s32   top;
  223.     __s32   width;
  224.     __s32   height;
  225. };
  226.  
  227. struct v4l2_fract {
  228.     __u32   numerator;
  229.     __u32   denominator;
  230. };
  231.  
  232. /*
  233.  *    D R I V E R   C A P A B I L I T I E S
  234.  */
  235. struct v4l2_capability {
  236.     __u8    driver[16];    /* i.e. "bttv" */
  237.     __u8    card[32];    /* i.e. "Hauppauge WinTV" */
  238.     __u8    bus_info[32];    /* "PCI:" + pci_name(pci_dev) */
  239.     __u32   version;        /* should use KERNEL_VERSION() */
  240.     __u32    capabilities;    /* Device capabilities */
  241.     __u32    reserved[4];
  242. };
  243.  
  244. /* Values for 'capabilities' field */
  245. #define V4L2_CAP_VIDEO_CAPTURE        0x00000001  /* Is a video capture device */
  246. #define V4L2_CAP_VIDEO_OUTPUT        0x00000002  /* Is a video output device */
  247. #define V4L2_CAP_VIDEO_OVERLAY        0x00000004  /* Can do video overlay */
  248. #define V4L2_CAP_VBI_CAPTURE        0x00000010  /* Is a raw VBI capture device */
  249. #define V4L2_CAP_VBI_OUTPUT        0x00000020  /* Is a raw VBI output device */
  250. #define V4L2_CAP_SLICED_VBI_CAPTURE    0x00000040  /* Is a sliced VBI capture device */
  251. #define V4L2_CAP_SLICED_VBI_OUTPUT    0x00000080  /* Is a sliced VBI output device */
  252. #define V4L2_CAP_RDS_CAPTURE        0x00000100  /* RDS data capture */
  253. #define V4L2_CAP_VIDEO_OUTPUT_OVERLAY    0x00000200  /* Can do video output overlay */
  254. #define V4L2_CAP_HW_FREQ_SEEK        0x00000400  /* Can do hardware frequency seek  */
  255.  
  256. #define V4L2_CAP_TUNER            0x00010000  /* has a tuner */
  257. #define V4L2_CAP_AUDIO            0x00020000  /* has audio support */
  258. #define V4L2_CAP_RADIO            0x00040000  /* is a radio device */
  259.  
  260. #define V4L2_CAP_READWRITE              0x01000000  /* read/write systemcalls */
  261. #define V4L2_CAP_ASYNCIO                0x02000000  /* async I/O */
  262. #define V4L2_CAP_STREAMING              0x04000000  /* streaming I/O ioctls */
  263.  
  264. /*
  265.  *    V I D E O   I M A G E   F O R M A T
  266.  */
  267. struct v4l2_pix_format {
  268.     __u32                 width;
  269.     __u32            height;
  270.     __u32            pixelformat;
  271.     enum v4l2_field      field;
  272.     __u32                bytesperline;    /* for padding, zero if unused */
  273.     __u32                  sizeimage;
  274.     enum v4l2_colorspace    colorspace;
  275.     __u32            priv;        /* private data, depends on pixelformat */
  276. };
  277.  
  278. /*      Pixel format         FOURCC                        depth  Description  */
  279. #define V4L2_PIX_FMT_RGB332  v4l2_fourcc('R', 'G', 'B', '1') /*  8  RGB-3-3-2     */
  280. #define V4L2_PIX_FMT_RGB444  v4l2_fourcc('R', '4', '4', '4') /* 16  xxxxrrrr ggggbbbb */
  281. #define V4L2_PIX_FMT_RGB555  v4l2_fourcc('R', 'G', 'B', 'O') /* 16  RGB-5-5-5     */
  282. #define V4L2_PIX_FMT_RGB565  v4l2_fourcc('R', 'G', 'B', 'P') /* 16  RGB-5-6-5     */
  283. #define V4L2_PIX_FMT_RGB555X v4l2_fourcc('R', 'G', 'B', 'Q') /* 16  RGB-5-5-5 BE  */
  284. #define V4L2_PIX_FMT_RGB565X v4l2_fourcc('R', 'G', 'B', 'R') /* 16  RGB-5-6-5 BE  */
  285. #define V4L2_PIX_FMT_BGR24   v4l2_fourcc('B', 'G', 'R', '3') /* 24  BGR-8-8-8     */
  286. #define V4L2_PIX_FMT_RGB24   v4l2_fourcc('R', 'G', 'B', '3') /* 24  RGB-8-8-8     */
  287. #define V4L2_PIX_FMT_BGR32   v4l2_fourcc('B', 'G', 'R', '4') /* 32  BGR-8-8-8-8   */
  288. #define V4L2_PIX_FMT_RGB32   v4l2_fourcc('R', 'G', 'B', '4') /* 32  RGB-8-8-8-8   */
  289. #define V4L2_PIX_FMT_GREY    v4l2_fourcc('G', 'R', 'E', 'Y') /*  8  Greyscale     */
  290. #define V4L2_PIX_FMT_Y16     v4l2_fourcc('Y', '1', '6', ' ') /* 16  Greyscale     */
  291. #define V4L2_PIX_FMT_PAL8    v4l2_fourcc('P', 'A', 'L', '8') /*  8  8-bit palette */
  292. #define V4L2_PIX_FMT_YVU410  v4l2_fourcc('Y', 'V', 'U', '9') /*  9  YVU 4:1:0     */
  293. #define V4L2_PIX_FMT_YVU420  v4l2_fourcc('Y', 'V', '1', '2') /* 12  YVU 4:2:0     */
  294. #define V4L2_PIX_FMT_YUYV    v4l2_fourcc('Y', 'U', 'Y', 'V') /* 16  YUV 4:2:2     */
  295. #define V4L2_PIX_FMT_UYVY    v4l2_fourcc('U', 'Y', 'V', 'Y') /* 16  YUV 4:2:2     */
  296. #define V4L2_PIX_FMT_YUV422P v4l2_fourcc('4', '2', '2', 'P') /* 16  YVU422 planar */
  297. #define V4L2_PIX_FMT_YUV411P v4l2_fourcc('4', '1', '1', 'P') /* 16  YVU411 planar */
  298. #define V4L2_PIX_FMT_Y41P    v4l2_fourcc('Y', '4', '1', 'P') /* 12  YUV 4:1:1     */
  299. #define V4L2_PIX_FMT_YUV444  v4l2_fourcc('Y', '4', '4', '4') /* 16  xxxxyyyy uuuuvvvv */
  300. #define V4L2_PIX_FMT_YUV555  v4l2_fourcc('Y', 'U', 'V', 'O') /* 16  YUV-5-5-5     */
  301. #define V4L2_PIX_FMT_YUV565  v4l2_fourcc('Y', 'U', 'V', 'P') /* 16  YUV-5-6-5     */
  302. #define V4L2_PIX_FMT_YUV32   v4l2_fourcc('Y', 'U', 'V', '4') /* 32  YUV-8-8-8-8   */
  303.  
  304. /* two planes -- one Y, one Cr + Cb interleaved  */
  305. #define V4L2_PIX_FMT_NV12    v4l2_fourcc('N', 'V', '1', '2') /* 12  Y/CbCr 4:2:0  */
  306. #define V4L2_PIX_FMT_NV21    v4l2_fourcc('N', 'V', '2', '1') /* 12  Y/CrCb 4:2:0  */
  307.  
  308. /*  The following formats are not defined in the V4L2 specification */
  309. #define V4L2_PIX_FMT_YUV410  v4l2_fourcc('Y', 'U', 'V', '9') /*  9  YUV 4:1:0     */
  310. #define V4L2_PIX_FMT_YUV420  v4l2_fourcc('Y', 'U', '1', '2') /* 12  YUV 4:2:0     */
  311. #define V4L2_PIX_FMT_YYUV    v4l2_fourcc('Y', 'Y', 'U', 'V') /* 16  YUV 4:2:2     */
  312. #define V4L2_PIX_FMT_HI240   v4l2_fourcc('H', 'I', '2', '4') /*  8  8-bit color   */
  313. #define V4L2_PIX_FMT_HM12    v4l2_fourcc('H', 'M', '1', '2') /*  8  YUV 4:2:0 16x16 macroblocks */
  314.  
  315. /* see http://www.siliconimaging.com/RGB%20Bayer.htm */
  316. #define V4L2_PIX_FMT_SBGGR8  v4l2_fourcc('B', 'A', '8', '1') /*  8  BGBG.. GRGR.. */
  317. #define V4L2_PIX_FMT_SGBRG8  v4l2_fourcc('G', 'B', 'R', 'G') /*  8  GBGB.. RGRG.. */
  318. /*
  319.  * 10bit raw bayer, expanded to 16 bits
  320.  * xxxxrrrrrrrrrrxxxxgggggggggg xxxxggggggggggxxxxbbbbbbbbbb...
  321.  */
  322. #define V4L2_PIX_FMT_SGRBG10 v4l2_fourcc('B', 'A', '1', '0')
  323. /* 10bit raw bayer DPCM compressed to 8 bits */
  324. #define V4L2_PIX_FMT_SGRBG10DPCM8 v4l2_fourcc('B', 'D', '1', '0')
  325. #define V4L2_PIX_FMT_SBGGR16 v4l2_fourcc('B', 'Y', 'R', '2') /* 16  BGBG.. GRGR.. */
  326.  
  327. /* compressed formats */
  328. #define V4L2_PIX_FMT_MJPEG    v4l2_fourcc('M', 'J', 'P', 'G') /* Motion-JPEG   */
  329. #define V4L2_PIX_FMT_JPEG     v4l2_fourcc('J', 'P', 'E', 'G') /* JFIF JPEG     */
  330. #define V4L2_PIX_FMT_DV       v4l2_fourcc('d', 'v', 's', 'd') /* 1394          */
  331. #define V4L2_PIX_FMT_MPEG     v4l2_fourcc('M', 'P', 'E', 'G') /* MPEG-1/2/4    */
  332.  
  333. /*  Vendor-specific formats   */
  334. #define V4L2_PIX_FMT_WNVA     v4l2_fourcc('W', 'N', 'V', 'A') /* Winnov hw compress */
  335. #define V4L2_PIX_FMT_SN9C10X  v4l2_fourcc('S', '9', '1', '0') /* SN9C10x compression */
  336. #define V4L2_PIX_FMT_PWC1     v4l2_fourcc('P', 'W', 'C', '1') /* pwc older webcam */
  337. #define V4L2_PIX_FMT_PWC2     v4l2_fourcc('P', 'W', 'C', '2') /* pwc newer webcam */
  338. #define V4L2_PIX_FMT_ET61X251 v4l2_fourcc('E', '6', '2', '5') /* ET61X251 compression */
  339. #define V4L2_PIX_FMT_SPCA501  v4l2_fourcc('S', '5', '0', '1') /* YUYV per line */
  340. #define V4L2_PIX_FMT_SPCA505  v4l2_fourcc('S', '5', '0', '5') /* YYUV per line */
  341. #define V4L2_PIX_FMT_SPCA508  v4l2_fourcc('S', '5', '0', '8') /* YUVY per line */
  342. #define V4L2_PIX_FMT_SPCA561  v4l2_fourcc('S', '5', '6', '1') /* compressed GBRG bayer */
  343. #define V4L2_PIX_FMT_PAC207   v4l2_fourcc('P', '2', '0', '7') /* compressed BGGR bayer */
  344. #define V4L2_PIX_FMT_PJPG     v4l2_fourcc('P', 'J', 'P', 'G') /* Pixart 73xx JPEG */
  345. #define V4L2_PIX_FMT_YVYU    v4l2_fourcc('Y', 'V', 'Y', 'U') /* 16  YVU 4:2:2     */
  346.  
  347. /*
  348.  *    F O R M A T   E N U M E R A T I O N
  349.  */
  350. struct v4l2_fmtdesc {
  351.     __u32            index;             /* Format number      */
  352.     enum v4l2_buf_type  type;              /* buffer type        */
  353.     __u32               flags;
  354.     __u8            description[32];   /* Description string */
  355.     __u32            pixelformat;       /* Format fourcc      */
  356.     __u32            reserved[4];
  357. };
  358.  
  359. #define V4L2_FMT_FLAG_COMPRESSED 0x0001
  360.  
  361. #if 1
  362.     /* Experimental Frame Size and frame rate enumeration */
  363. /*
  364.  *    F R A M E   S I Z E   E N U M E R A T I O N
  365.  */
  366. enum v4l2_frmsizetypes {
  367.     V4L2_FRMSIZE_TYPE_DISCRETE    = 1,
  368.     V4L2_FRMSIZE_TYPE_CONTINUOUS    = 2,
  369.     V4L2_FRMSIZE_TYPE_STEPWISE    = 3,
  370. };
  371.  
  372. struct v4l2_frmsize_discrete {
  373.     __u32            width;        /* Frame width [pixel] */
  374.     __u32            height;        /* Frame height [pixel] */
  375. };
  376.  
  377. struct v4l2_frmsize_stepwise {
  378.     __u32            min_width;    /* Minimum frame width [pixel] */
  379.     __u32            max_width;    /* Maximum frame width [pixel] */
  380.     __u32            step_width;    /* Frame width step size [pixel] */
  381.     __u32            min_height;    /* Minimum frame height [pixel] */
  382.     __u32            max_height;    /* Maximum frame height [pixel] */
  383.     __u32            step_height;    /* Frame height step size [pixel] */
  384. };
  385.  
  386. struct v4l2_frmsizeenum {
  387.     __u32            index;        /* Frame size number */
  388.     __u32            pixel_format;    /* Pixel format */
  389.     __u32            type;        /* Frame size type the device supports. */
  390.  
  391.     union {                    /* Frame size */
  392.         struct v4l2_frmsize_discrete    discrete;
  393.         struct v4l2_frmsize_stepwise    stepwise;
  394.     };
  395.  
  396.     __u32   reserved[2];            /* Reserved space for future use */
  397. };
  398.  
  399. /*
  400.  *    F R A M E   R A T E   E N U M E R A T I O N
  401.  */
  402. enum v4l2_frmivaltypes {
  403.     V4L2_FRMIVAL_TYPE_DISCRETE    = 1,
  404.     V4L2_FRMIVAL_TYPE_CONTINUOUS    = 2,
  405.     V4L2_FRMIVAL_TYPE_STEPWISE    = 3,
  406. };
  407.  
  408. struct v4l2_frmival_stepwise {
  409.     struct v4l2_fract    min;        /* Minimum frame interval [s] */
  410.     struct v4l2_fract    max;        /* Maximum frame interval [s] */
  411.     struct v4l2_fract    step;        /* Frame interval step size [s] */
  412. };
  413.  
  414. struct v4l2_frmivalenum {
  415.     __u32            index;        /* Frame format index */
  416.     __u32            pixel_format;    /* Pixel format */
  417.     __u32            width;        /* Frame width */
  418.     __u32            height;        /* Frame height */
  419.     __u32            type;        /* Frame interval type the device supports. */
  420.  
  421.     union {                    /* Frame interval */
  422.         struct v4l2_fract        discrete;
  423.         struct v4l2_frmival_stepwise    stepwise;
  424.     };
  425.  
  426.     __u32    reserved[2];            /* Reserved space for future use */
  427. };
  428. #endif
  429.  
  430. /*
  431.  *    T I M E C O D E
  432.  */
  433. struct v4l2_timecode {
  434.     __u32    type;
  435.     __u32    flags;
  436.     __u8    frames;
  437.     __u8    seconds;
  438.     __u8    minutes;
  439.     __u8    hours;
  440.     __u8    userbits[4];
  441. };
  442.  
  443. /*  Type  */
  444. #define V4L2_TC_TYPE_24FPS        1
  445. #define V4L2_TC_TYPE_25FPS        2
  446. #define V4L2_TC_TYPE_30FPS        3
  447. #define V4L2_TC_TYPE_50FPS        4
  448. #define V4L2_TC_TYPE_60FPS        5
  449.  
  450. /*  Flags  */
  451. #define V4L2_TC_FLAG_DROPFRAME        0x0001 /* "drop-frame" mode */
  452. #define V4L2_TC_FLAG_COLORFRAME        0x0002
  453. #define V4L2_TC_USERBITS_field        0x000C
  454. #define V4L2_TC_USERBITS_USERDEFINED    0x0000
  455. #define V4L2_TC_USERBITS_8BITCHARS    0x0008
  456. /* The above is based on SMPTE timecodes */
  457.  
  458. struct v4l2_jpegcompression {
  459.     int quality;
  460.  
  461.     int  APPn;              /* Number of APP segment to be written,
  462.                  * must be 0..15 */
  463.     int  APP_len;           /* Length of data in JPEG APPn segment */
  464.     char APP_data[60];      /* Data in the JPEG APPn segment. */
  465.  
  466.     int  COM_len;           /* Length of data in JPEG COM segment */
  467.     char COM_data[60];      /* Data in JPEG COM segment */
  468.  
  469.     __u32 jpeg_markers;     /* Which markers should go into the JPEG
  470.                  * output. Unless you exactly know what
  471.                  * you do, leave them untouched.
  472.                  * Inluding less markers will make the
  473.                  * resulting code smaller, but there will
  474.                  * be fewer aplications which can read it.
  475.                  * The presence of the APP and COM marker
  476.                  * is influenced by APP_len and COM_len
  477.                  * ONLY, not by this property! */
  478.  
  479. #define V4L2_JPEG_MARKER_DHT (1<<3)    /* Define Huffman Tables */
  480. #define V4L2_JPEG_MARKER_DQT (1<<4)    /* Define Quantization Tables */
  481. #define V4L2_JPEG_MARKER_DRI (1<<5)    /* Define Restart Interval */
  482. #define V4L2_JPEG_MARKER_COM (1<<6)    /* Comment segment */
  483. #define V4L2_JPEG_MARKER_APP (1<<7)    /* App segment, driver will
  484.                     * allways use APP0 */
  485. };
  486.  
  487. /*
  488.  *    M E M O R Y - M A P P I N G   B U F F E R S
  489.  */
  490. struct v4l2_requestbuffers {
  491.     __u32            count;
  492.     enum v4l2_buf_type      type;
  493.     enum v4l2_memory        memory;
  494.     __u32            reserved[2];
  495. };
  496.  
  497. struct v4l2_buffer {
  498.     __u32            index;
  499.     enum v4l2_buf_type      type;
  500.     __u32            bytesused;
  501.     __u32            flags;
  502.     enum v4l2_field        field;
  503.     struct timeval        timestamp;
  504.     struct v4l2_timecode    timecode;
  505.     __u32            sequence;
  506.  
  507.     /* memory location */
  508.     enum v4l2_memory        memory;
  509.     union {
  510.         __u32           offset;
  511.         unsigned long   userptr;
  512.     } m;
  513.     __u32            length;
  514.     __u32            input;
  515.     __u32            reserved;
  516. };
  517.  
  518. /*  Flags for 'flags' field */
  519. #define V4L2_BUF_FLAG_MAPPED    0x0001  /* Buffer is mapped (flag) */
  520. #define V4L2_BUF_FLAG_QUEUED    0x0002    /* Buffer is queued for processing */
  521. #define V4L2_BUF_FLAG_DONE    0x0004    /* Buffer is ready */
  522. #define V4L2_BUF_FLAG_KEYFRAME    0x0008    /* Image is a keyframe (I-frame) */
  523. #define V4L2_BUF_FLAG_PFRAME    0x0010    /* Image is a P-frame */
  524. #define V4L2_BUF_FLAG_BFRAME    0x0020    /* Image is a B-frame */
  525. #define V4L2_BUF_FLAG_TIMECODE    0x0100    /* timecode field is valid */
  526. #define V4L2_BUF_FLAG_INPUT     0x0200  /* input field is valid */
  527.  
  528. /*
  529.  *    O V E R L A Y   P R E V I E W
  530.  */
  531. struct v4l2_framebuffer {
  532.     __u32            capability;
  533.     __u32            flags;
  534. /* FIXME: in theory we should pass something like PCI device + memory
  535.  * region + offset instead of some physical address */
  536.     void                    *base;
  537.     struct v4l2_pix_format    fmt;
  538. };
  539. /*  Flags for the 'capability' field. Read only */
  540. #define V4L2_FBUF_CAP_EXTERNOVERLAY    0x0001
  541. #define V4L2_FBUF_CAP_CHROMAKEY        0x0002
  542. #define V4L2_FBUF_CAP_LIST_CLIPPING     0x0004
  543. #define V4L2_FBUF_CAP_BITMAP_CLIPPING    0x0008
  544. #define V4L2_FBUF_CAP_LOCAL_ALPHA    0x0010
  545. #define V4L2_FBUF_CAP_GLOBAL_ALPHA    0x0020
  546. #define V4L2_FBUF_CAP_LOCAL_INV_ALPHA    0x0040
  547. /*  Flags for the 'flags' field. */
  548. #define V4L2_FBUF_FLAG_PRIMARY        0x0001
  549. #define V4L2_FBUF_FLAG_OVERLAY        0x0002
  550. #define V4L2_FBUF_FLAG_CHROMAKEY    0x0004
  551. #define V4L2_FBUF_FLAG_LOCAL_ALPHA    0x0008
  552. #define V4L2_FBUF_FLAG_GLOBAL_ALPHA    0x0010
  553. #define V4L2_FBUF_FLAG_LOCAL_INV_ALPHA    0x0020
  554.  
  555. struct v4l2_clip {
  556.     struct v4l2_rect        c;
  557.     struct v4l2_clip    __user *next;
  558. };
  559.  
  560. struct v4l2_window {
  561.     struct v4l2_rect        w;
  562.     enum v4l2_field      field;
  563.     __u32            chromakey;
  564.     struct v4l2_clip    __user *clips;
  565.     __u32            clipcount;
  566.     void            __user *bitmap;
  567.     __u8                    global_alpha;
  568. };
  569.  
  570. /*
  571.  *    C A P T U R E   P A R A M E T E R S
  572.  */
  573. struct v4l2_captureparm {
  574.     __u32           capability;      /*  Supported modes */
  575.     __u32           capturemode;      /*  Current mode */
  576.     struct v4l2_fract  timeperframe;  /*  Time per frame in .1us units */
  577.     __u32           extendedmode;  /*  Driver-specific extensions */
  578.     __u32              readbuffers;   /*  # of buffers for read */
  579.     __u32           reserved[4];
  580. };
  581.  
  582. /*  Flags for 'capability' and 'capturemode' fields */
  583. #define V4L2_MODE_HIGHQUALITY    0x0001    /*  High quality imaging mode */
  584. #define V4L2_CAP_TIMEPERFRAME    0x1000    /*  timeperframe field is supported */
  585.  
  586. struct v4l2_outputparm {
  587.     __u32           capability;     /*  Supported modes */
  588.     __u32           outputmode;     /*  Current mode */
  589.     struct v4l2_fract  timeperframe; /*  Time per frame in seconds */
  590.     __u32           extendedmode; /*  Driver-specific extensions */
  591.     __u32              writebuffers; /*  # of buffers for write */
  592.     __u32           reserved[4];
  593. };
  594.  
  595. /*
  596.  *    I N P U T   I M A G E   C R O P P I N G
  597.  */
  598. struct v4l2_cropcap {
  599.     enum v4l2_buf_type      type;
  600.     struct v4l2_rect        bounds;
  601.     struct v4l2_rect        defrect;
  602.     struct v4l2_fract       pixelaspect;
  603. };
  604.  
  605. struct v4l2_crop {
  606.     enum v4l2_buf_type      type;
  607.     struct v4l2_rect        c;
  608. };
  609.  
  610. /*
  611.  *      A N A L O G   V I D E O   S T A N D A R D
  612.  */
  613.  
  614. typedef __u64 v4l2_std_id;
  615.  
  616. /* one bit for each */
  617. #define V4L2_STD_PAL_B          ((v4l2_std_id)0x00000001)
  618. #define V4L2_STD_PAL_B1         ((v4l2_std_id)0x00000002)
  619. #define V4L2_STD_PAL_G          ((v4l2_std_id)0x00000004)
  620. #define V4L2_STD_PAL_H          ((v4l2_std_id)0x00000008)
  621. #define V4L2_STD_PAL_I          ((v4l2_std_id)0x00000010)
  622. #define V4L2_STD_PAL_D          ((v4l2_std_id)0x00000020)
  623. #define V4L2_STD_PAL_D1         ((v4l2_std_id)0x00000040)
  624. #define V4L2_STD_PAL_K          ((v4l2_std_id)0x00000080)
  625.  
  626. #define V4L2_STD_PAL_M          ((v4l2_std_id)0x00000100)
  627. #define V4L2_STD_PAL_N          ((v4l2_std_id)0x00000200)
  628. #define V4L2_STD_PAL_Nc         ((v4l2_std_id)0x00000400)
  629. #define V4L2_STD_PAL_60         ((v4l2_std_id)0x00000800)
  630.  
  631. #define V4L2_STD_NTSC_M         ((v4l2_std_id)0x00001000)
  632. #define V4L2_STD_NTSC_M_JP      ((v4l2_std_id)0x00002000)
  633. #define V4L2_STD_NTSC_443       ((v4l2_std_id)0x00004000)
  634. #define V4L2_STD_NTSC_M_KR      ((v4l2_std_id)0x00008000)
  635.  
  636. #define V4L2_STD_SECAM_B        ((v4l2_std_id)0x00010000)
  637. #define V4L2_STD_SECAM_D        ((v4l2_std_id)0x00020000)
  638. #define V4L2_STD_SECAM_G        ((v4l2_std_id)0x00040000)
  639. #define V4L2_STD_SECAM_H        ((v4l2_std_id)0x00080000)
  640. #define V4L2_STD_SECAM_K        ((v4l2_std_id)0x00100000)
  641. #define V4L2_STD_SECAM_K1       ((v4l2_std_id)0x00200000)
  642. #define V4L2_STD_SECAM_L        ((v4l2_std_id)0x00400000)
  643. #define V4L2_STD_SECAM_LC       ((v4l2_std_id)0x00800000)
  644.  
  645. /* ATSC/HDTV */
  646. #define V4L2_STD_ATSC_8_VSB     ((v4l2_std_id)0x01000000)
  647. #define V4L2_STD_ATSC_16_VSB    ((v4l2_std_id)0x02000000)
  648.  
  649. /* FIXME:
  650.    Although std_id is 64 bits, there is an issue on PPC32 architecture that
  651.    makes switch(__u64) to break. So, there's a hack on v4l2-common.c rounding
  652.    this value to 32 bits.
  653.    As, currently, the max value is for V4L2_STD_ATSC_16_VSB (30 bits wide),
  654.    it should work fine. However, if needed to add more than two standards,
  655.    v4l2-common.c should be fixed.
  656.  */
  657.  
  658. /* some merged standards */
  659. #define V4L2_STD_MN    (V4L2_STD_PAL_M|V4L2_STD_PAL_N|V4L2_STD_PAL_Nc|V4L2_STD_NTSC)
  660. #define V4L2_STD_B    (V4L2_STD_PAL_B|V4L2_STD_PAL_B1|V4L2_STD_SECAM_B)
  661. #define V4L2_STD_GH    (V4L2_STD_PAL_G|V4L2_STD_PAL_H|V4L2_STD_SECAM_G|V4L2_STD_SECAM_H)
  662. #define V4L2_STD_DK    (V4L2_STD_PAL_DK|V4L2_STD_SECAM_DK)
  663.  
  664. /* some common needed stuff */
  665. #define V4L2_STD_PAL_BG        (V4L2_STD_PAL_B        |\
  666.                  V4L2_STD_PAL_B1    |\
  667.                  V4L2_STD_PAL_G)
  668. #define V4L2_STD_PAL_DK        (V4L2_STD_PAL_D        |\
  669.                  V4L2_STD_PAL_D1    |\
  670.                  V4L2_STD_PAL_K)
  671. #define V4L2_STD_PAL        (V4L2_STD_PAL_BG    |\
  672.                  V4L2_STD_PAL_DK    |\
  673.                  V4L2_STD_PAL_H        |\
  674.                  V4L2_STD_PAL_I)
  675. #define V4L2_STD_NTSC           (V4L2_STD_NTSC_M    |\
  676.                  V4L2_STD_NTSC_M_JP     |\
  677.                  V4L2_STD_NTSC_M_KR)
  678. #define V4L2_STD_SECAM_DK          (V4L2_STD_SECAM_D    |\
  679.                  V4L2_STD_SECAM_K    |\
  680.                  V4L2_STD_SECAM_K1)
  681. #define V4L2_STD_SECAM        (V4L2_STD_SECAM_B    |\
  682.                  V4L2_STD_SECAM_G    |\
  683.                  V4L2_STD_SECAM_H    |\
  684.                  V4L2_STD_SECAM_DK    |\
  685.                  V4L2_STD_SECAM_L       |\
  686.                  V4L2_STD_SECAM_LC)
  687.  
  688. #define V4L2_STD_525_60        (V4L2_STD_PAL_M        |\
  689.                  V4L2_STD_PAL_60    |\
  690.                  V4L2_STD_NTSC        |\
  691.                  V4L2_STD_NTSC_443)
  692. #define V4L2_STD_625_50        (V4L2_STD_PAL        |\
  693.                  V4L2_STD_PAL_N        |\
  694.                  V4L2_STD_PAL_Nc    |\
  695.                  V4L2_STD_SECAM)
  696. #define V4L2_STD_ATSC           (V4L2_STD_ATSC_8_VSB    |\
  697.                  V4L2_STD_ATSC_16_VSB)
  698.  
  699. #define V4L2_STD_UNKNOWN        0
  700. #define V4L2_STD_ALL            (V4L2_STD_525_60    |\
  701.                  V4L2_STD_625_50)
  702.  
  703. struct v4l2_standard {
  704.     __u32             index;
  705.     v4l2_std_id          id;
  706.     __u8             name[24];
  707.     struct v4l2_fract    frameperiod; /* Frames, not fields */
  708.     __u32             framelines;
  709.     __u32             reserved[4];
  710. };
  711.  
  712. /*
  713.  *    V I D E O   I N P U T S
  714.  */
  715. struct v4l2_input {
  716.     __u32         index;        /*  Which input */
  717.     __u8         name[32];        /*  Label */
  718.     __u32         type;        /*  Type of input */
  719.     __u32         audioset;        /*  Associated audios (bitfield) */
  720.     __u32        tuner;             /*  Associated tuner */
  721.     v4l2_std_id  std;
  722.     __u32         status;
  723.     __u32         reserved[4];
  724. };
  725.  
  726. /*  Values for the 'type' field */
  727. #define V4L2_INPUT_TYPE_TUNER        1
  728. #define V4L2_INPUT_TYPE_CAMERA        2
  729.  
  730. /* field 'status' - general */
  731. #define V4L2_IN_ST_NO_POWER    0x00000001  /* Attached device is off */
  732. #define V4L2_IN_ST_NO_SIGNAL   0x00000002
  733. #define V4L2_IN_ST_NO_COLOR    0x00000004
  734.  
  735. /* field 'status' - analog */
  736. #define V4L2_IN_ST_NO_H_LOCK   0x00000100  /* No horizontal sync lock */
  737. #define V4L2_IN_ST_COLOR_KILL  0x00000200  /* Color killer is active */
  738.  
  739. /* field 'status' - digital */
  740. #define V4L2_IN_ST_NO_SYNC     0x00010000  /* No synchronization lock */
  741. #define V4L2_IN_ST_NO_EQU      0x00020000  /* No equalizer lock */
  742. #define V4L2_IN_ST_NO_CARRIER  0x00040000  /* Carrier recovery failed */
  743.  
  744. /* field 'status' - VCR and set-top box */
  745. #define V4L2_IN_ST_MACROVISION 0x01000000  /* Macrovision detected */
  746. #define V4L2_IN_ST_NO_ACCESS   0x02000000  /* Conditional access denied */
  747. #define V4L2_IN_ST_VTR         0x04000000  /* VTR time constant */
  748.  
  749. /*
  750.  *    V I D E O   O U T P U T S
  751.  */
  752. struct v4l2_output {
  753.     __u32         index;        /*  Which output */
  754.     __u8         name[32];        /*  Label */
  755.     __u32         type;        /*  Type of output */
  756.     __u32         audioset;        /*  Associated audios (bitfield) */
  757.     __u32         modulator;         /*  Associated modulator */
  758.     v4l2_std_id  std;
  759.     __u32         reserved[4];
  760. };
  761. /*  Values for the 'type' field */
  762. #define V4L2_OUTPUT_TYPE_MODULATOR        1
  763. #define V4L2_OUTPUT_TYPE_ANALOG            2
  764. #define V4L2_OUTPUT_TYPE_ANALOGVGAOVERLAY    3
  765.  
  766. /*
  767.  *    C O N T R O L S
  768.  */
  769. struct v4l2_control {
  770.     __u32             id;
  771.     __s32             value;
  772. };
  773.  
  774. struct v4l2_ext_control {
  775.     __u32 id;
  776.     __u32 reserved2[2];
  777.     union {
  778.         __s32 value;
  779.         __s64 value64;
  780.         void *reserved;
  781.     };
  782. } __attribute__ ((packed));
  783.  
  784. struct v4l2_ext_controls {
  785.     __u32 ctrl_class;
  786.     __u32 count;
  787.     __u32 error_idx;
  788.     __u32 reserved[2];
  789.     struct v4l2_ext_control *controls;
  790. };
  791.  
  792. /*  Values for ctrl_class field */
  793. #define V4L2_CTRL_CLASS_USER 0x00980000    /* Old-style 'user' controls */
  794. #define V4L2_CTRL_CLASS_MPEG 0x00990000    /* MPEG-compression controls */
  795. #define V4L2_CTRL_CLASS_CAMERA 0x009a0000    /* Camera class controls */
  796.  
  797. #define V4L2_CTRL_ID_MASK            (0x0fffffff)
  798. #define V4L2_CTRL_ID2CLASS(id)    ((id) & 0x0fff0000UL)
  799. #define V4L2_CTRL_DRIVER_PRIV(id) (((id) & 0xffff) >= 0x1000)
  800.  
  801. /*  Used in the VIDIOC_QUERYCTRL ioctl for querying controls */
  802. struct v4l2_queryctrl {
  803.     __u32             id;
  804.     enum v4l2_ctrl_type  type;
  805.     __u8             name[32];    /* Whatever */
  806.     __s32             minimum;    /* Note signedness */
  807.     __s32             maximum;
  808.     __s32             step;
  809.     __s32             default_value;
  810.     __u32                flags;
  811.     __u32             reserved[2];
  812. };
  813.  
  814. /*  Used in the VIDIOC_QUERYMENU ioctl for querying menu items */
  815. struct v4l2_querymenu {
  816.     __u32        id;
  817.     __u32        index;
  818.     __u8        name[32];    /* Whatever */
  819.     __u32        reserved;
  820. };
  821.  
  822. /*  Control flags  */
  823. #define V4L2_CTRL_FLAG_DISABLED        0x0001
  824. #define V4L2_CTRL_FLAG_GRABBED        0x0002
  825. #define V4L2_CTRL_FLAG_READ_ONLY     0x0004
  826. #define V4L2_CTRL_FLAG_UPDATE         0x0008
  827. #define V4L2_CTRL_FLAG_INACTIVE     0x0010
  828. #define V4L2_CTRL_FLAG_SLIDER         0x0020
  829.  
  830. /*  Query flag, to be ORed with the control ID */
  831. #define V4L2_CTRL_FLAG_NEXT_CTRL    0x80000000
  832.  
  833. /*  User-class control IDs defined by V4L2 */
  834. #define V4L2_CID_BASE            (V4L2_CTRL_CLASS_USER | 0x900)
  835. #define V4L2_CID_USER_BASE         V4L2_CID_BASE
  836. /*  IDs reserved for driver specific controls */
  837. #define V4L2_CID_PRIVATE_BASE        0x08000000
  838.  
  839. #define V4L2_CID_USER_CLASS         (V4L2_CTRL_CLASS_USER | 1)
  840. #define V4L2_CID_BRIGHTNESS        (V4L2_CID_BASE+0)
  841. #define V4L2_CID_CONTRAST        (V4L2_CID_BASE+1)
  842. #define V4L2_CID_SATURATION        (V4L2_CID_BASE+2)
  843. #define V4L2_CID_HUE            (V4L2_CID_BASE+3)
  844. #define V4L2_CID_AUDIO_VOLUME        (V4L2_CID_BASE+5)
  845. #define V4L2_CID_AUDIO_BALANCE        (V4L2_CID_BASE+6)
  846. #define V4L2_CID_AUDIO_BASS        (V4L2_CID_BASE+7)
  847. #define V4L2_CID_AUDIO_TREBLE        (V4L2_CID_BASE+8)
  848. #define V4L2_CID_AUDIO_MUTE        (V4L2_CID_BASE+9)
  849. #define V4L2_CID_AUDIO_LOUDNESS        (V4L2_CID_BASE+10)
  850. #define V4L2_CID_BLACK_LEVEL        (V4L2_CID_BASE+11) /* Deprecated */
  851. #define V4L2_CID_AUTO_WHITE_BALANCE    (V4L2_CID_BASE+12)
  852. #define V4L2_CID_DO_WHITE_BALANCE    (V4L2_CID_BASE+13)
  853. #define V4L2_CID_RED_BALANCE        (V4L2_CID_BASE+14)
  854. #define V4L2_CID_BLUE_BALANCE        (V4L2_CID_BASE+15)
  855. #define V4L2_CID_GAMMA            (V4L2_CID_BASE+16)
  856. #define V4L2_CID_WHITENESS        (V4L2_CID_GAMMA) /* Deprecated */
  857. #define V4L2_CID_EXPOSURE        (V4L2_CID_BASE+17)
  858. #define V4L2_CID_AUTOGAIN        (V4L2_CID_BASE+18)
  859. #define V4L2_CID_GAIN            (V4L2_CID_BASE+19)
  860. #define V4L2_CID_HFLIP            (V4L2_CID_BASE+20)
  861. #define V4L2_CID_VFLIP            (V4L2_CID_BASE+21)
  862.  
  863. /* Deprecated; use V4L2_CID_PAN_RESET and V4L2_CID_TILT_RESET */
  864. #define V4L2_CID_HCENTER        (V4L2_CID_BASE+22)
  865. #define V4L2_CID_VCENTER        (V4L2_CID_BASE+23)
  866.  
  867. #define V4L2_CID_POWER_LINE_FREQUENCY    (V4L2_CID_BASE+24)
  868. enum v4l2_power_line_frequency {
  869.     V4L2_CID_POWER_LINE_FREQUENCY_DISABLED    = 0,
  870.     V4L2_CID_POWER_LINE_FREQUENCY_50HZ    = 1,
  871.     V4L2_CID_POWER_LINE_FREQUENCY_60HZ    = 2,
  872. };
  873. #define V4L2_CID_HUE_AUTO            (V4L2_CID_BASE+25)
  874. #define V4L2_CID_WHITE_BALANCE_TEMPERATURE    (V4L2_CID_BASE+26)
  875. #define V4L2_CID_SHARPNESS            (V4L2_CID_BASE+27)
  876. #define V4L2_CID_BACKLIGHT_COMPENSATION     (V4L2_CID_BASE+28)
  877. #define V4L2_CID_CHROMA_AGC                     (V4L2_CID_BASE+29)
  878. #define V4L2_CID_COLOR_KILLER                   (V4L2_CID_BASE+30)
  879. /* last CID + 1 */
  880. #define V4L2_CID_LASTP1                         (V4L2_CID_BASE+31)
  881.  
  882. /*  MPEG-class control IDs defined by V4L2 */
  883. #define V4L2_CID_MPEG_BASE             (V4L2_CTRL_CLASS_MPEG | 0x900)
  884. #define V4L2_CID_MPEG_CLASS             (V4L2_CTRL_CLASS_MPEG | 1)
  885.  
  886. /*  MPEG streams */
  887. #define V4L2_CID_MPEG_STREAM_TYPE         (V4L2_CID_MPEG_BASE+0)
  888. enum v4l2_mpeg_stream_type {
  889.     V4L2_MPEG_STREAM_TYPE_MPEG2_PS   = 0, /* MPEG-2 program stream */
  890.     V4L2_MPEG_STREAM_TYPE_MPEG2_TS   = 1, /* MPEG-2 transport stream */
  891.     V4L2_MPEG_STREAM_TYPE_MPEG1_SS   = 2, /* MPEG-1 system stream */
  892.     V4L2_MPEG_STREAM_TYPE_MPEG2_DVD  = 3, /* MPEG-2 DVD-compatible stream */
  893.     V4L2_MPEG_STREAM_TYPE_MPEG1_VCD  = 4, /* MPEG-1 VCD-compatible stream */
  894.     V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD = 5, /* MPEG-2 SVCD-compatible stream */
  895. };
  896. #define V4L2_CID_MPEG_STREAM_PID_PMT         (V4L2_CID_MPEG_BASE+1)
  897. #define V4L2_CID_MPEG_STREAM_PID_AUDIO         (V4L2_CID_MPEG_BASE+2)
  898. #define V4L2_CID_MPEG_STREAM_PID_VIDEO         (V4L2_CID_MPEG_BASE+3)
  899. #define V4L2_CID_MPEG_STREAM_PID_PCR         (V4L2_CID_MPEG_BASE+4)
  900. #define V4L2_CID_MPEG_STREAM_PES_ID_AUDIO     (V4L2_CID_MPEG_BASE+5)
  901. #define V4L2_CID_MPEG_STREAM_PES_ID_VIDEO     (V4L2_CID_MPEG_BASE+6)
  902. #define V4L2_CID_MPEG_STREAM_VBI_FMT         (V4L2_CID_MPEG_BASE+7)
  903. enum v4l2_mpeg_stream_vbi_fmt {
  904.     V4L2_MPEG_STREAM_VBI_FMT_NONE = 0,  /* No VBI in the MPEG stream */
  905.     V4L2_MPEG_STREAM_VBI_FMT_IVTV = 1,  /* VBI in private packets, IVTV format */
  906. };
  907.  
  908. /*  MPEG audio */
  909. #define V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ     (V4L2_CID_MPEG_BASE+100)
  910. enum v4l2_mpeg_audio_sampling_freq {
  911.     V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100 = 0,
  912.     V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000 = 1,
  913.     V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000 = 2,
  914. };
  915. #define V4L2_CID_MPEG_AUDIO_ENCODING         (V4L2_CID_MPEG_BASE+101)
  916. enum v4l2_mpeg_audio_encoding {
  917.     V4L2_MPEG_AUDIO_ENCODING_LAYER_1 = 0,
  918.     V4L2_MPEG_AUDIO_ENCODING_LAYER_2 = 1,
  919.     V4L2_MPEG_AUDIO_ENCODING_LAYER_3 = 2,
  920.     V4L2_MPEG_AUDIO_ENCODING_AAC     = 3,
  921.     V4L2_MPEG_AUDIO_ENCODING_AC3     = 4,
  922. };
  923. #define V4L2_CID_MPEG_AUDIO_L1_BITRATE         (V4L2_CID_MPEG_BASE+102)
  924. enum v4l2_mpeg_audio_l1_bitrate {
  925.     V4L2_MPEG_AUDIO_L1_BITRATE_32K  = 0,
  926.     V4L2_MPEG_AUDIO_L1_BITRATE_64K  = 1,
  927.     V4L2_MPEG_AUDIO_L1_BITRATE_96K  = 2,
  928.     V4L2_MPEG_AUDIO_L1_BITRATE_128K = 3,
  929.     V4L2_MPEG_AUDIO_L1_BITRATE_160K = 4,
  930.     V4L2_MPEG_AUDIO_L1_BITRATE_192K = 5,
  931.     V4L2_MPEG_AUDIO_L1_BITRATE_224K = 6,
  932.     V4L2_MPEG_AUDIO_L1_BITRATE_256K = 7,
  933.     V4L2_MPEG_AUDIO_L1_BITRATE_288K = 8,
  934.     V4L2_MPEG_AUDIO_L1_BITRATE_320K = 9,
  935.     V4L2_MPEG_AUDIO_L1_BITRATE_352K = 10,
  936.     V4L2_MPEG_AUDIO_L1_BITRATE_384K = 11,
  937.     V4L2_MPEG_AUDIO_L1_BITRATE_416K = 12,
  938.     V4L2_MPEG_AUDIO_L1_BITRATE_448K = 13,
  939. };
  940. #define V4L2_CID_MPEG_AUDIO_L2_BITRATE         (V4L2_CID_MPEG_BASE+103)
  941. enum v4l2_mpeg_audio_l2_bitrate {
  942.     V4L2_MPEG_AUDIO_L2_BITRATE_32K  = 0,
  943.     V4L2_MPEG_AUDIO_L2_BITRATE_48K  = 1,
  944.     V4L2_MPEG_AUDIO_L2_BITRATE_56K  = 2,
  945.     V4L2_MPEG_AUDIO_L2_BITRATE_64K  = 3,
  946.     V4L2_MPEG_AUDIO_L2_BITRATE_80K  = 4,
  947.     V4L2_MPEG_AUDIO_L2_BITRATE_96K  = 5,
  948.     V4L2_MPEG_AUDIO_L2_BITRATE_112K = 6,
  949.     V4L2_MPEG_AUDIO_L2_BITRATE_128K = 7,
  950.     V4L2_MPEG_AUDIO_L2_BITRATE_160K = 8,
  951.     V4L2_MPEG_AUDIO_L2_BITRATE_192K = 9,
  952.     V4L2_MPEG_AUDIO_L2_BITRATE_224K = 10,
  953.     V4L2_MPEG_AUDIO_L2_BITRATE_256K = 11,
  954.     V4L2_MPEG_AUDIO_L2_BITRATE_320K = 12,
  955.     V4L2_MPEG_AUDIO_L2_BITRATE_384K = 13,
  956. };
  957. #define V4L2_CID_MPEG_AUDIO_L3_BITRATE         (V4L2_CID_MPEG_BASE+104)
  958. enum v4l2_mpeg_audio_l3_bitrate {
  959.     V4L2_MPEG_AUDIO_L3_BITRATE_32K  = 0,
  960.     V4L2_MPEG_AUDIO_L3_BITRATE_40K  = 1,
  961.     V4L2_MPEG_AUDIO_L3_BITRATE_48K  = 2,
  962.     V4L2_MPEG_AUDIO_L3_BITRATE_56K  = 3,
  963.     V4L2_MPEG_AUDIO_L3_BITRATE_64K  = 4,
  964.     V4L2_MPEG_AUDIO_L3_BITRATE_80K  = 5,
  965.     V4L2_MPEG_AUDIO_L3_BITRATE_96K  = 6,
  966.     V4L2_MPEG_AUDIO_L3_BITRATE_112K = 7,
  967.     V4L2_MPEG_AUDIO_L3_BITRATE_128K = 8,
  968.     V4L2_MPEG_AUDIO_L3_BITRATE_160K = 9,
  969.     V4L2_MPEG_AUDIO_L3_BITRATE_192K = 10,
  970.     V4L2_MPEG_AUDIO_L3_BITRATE_224K = 11,
  971.     V4L2_MPEG_AUDIO_L3_BITRATE_256K = 12,
  972.     V4L2_MPEG_AUDIO_L3_BITRATE_320K = 13,
  973. };
  974. #define V4L2_CID_MPEG_AUDIO_MODE         (V4L2_CID_MPEG_BASE+105)
  975. enum v4l2_mpeg_audio_mode {
  976.     V4L2_MPEG_AUDIO_MODE_STEREO       = 0,
  977.     V4L2_MPEG_AUDIO_MODE_JOINT_STEREO = 1,
  978.     V4L2_MPEG_AUDIO_MODE_DUAL         = 2,
  979.     V4L2_MPEG_AUDIO_MODE_MONO         = 3,
  980. };
  981. #define V4L2_CID_MPEG_AUDIO_MODE_EXTENSION     (V4L2_CID_MPEG_BASE+106)
  982. enum v4l2_mpeg_audio_mode_extension {
  983.     V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4  = 0,
  984.     V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_8  = 1,
  985.     V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_12 = 2,
  986.     V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16 = 3,
  987. };
  988. #define V4L2_CID_MPEG_AUDIO_EMPHASIS         (V4L2_CID_MPEG_BASE+107)
  989. enum v4l2_mpeg_audio_emphasis {
  990.     V4L2_MPEG_AUDIO_EMPHASIS_NONE         = 0,
  991.     V4L2_MPEG_AUDIO_EMPHASIS_50_DIV_15_uS = 1,
  992.     V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17    = 2,
  993. };
  994. #define V4L2_CID_MPEG_AUDIO_CRC         (V4L2_CID_MPEG_BASE+108)
  995. enum v4l2_mpeg_audio_crc {
  996.     V4L2_MPEG_AUDIO_CRC_NONE  = 0,
  997.     V4L2_MPEG_AUDIO_CRC_CRC16 = 1,
  998. };
  999. #define V4L2_CID_MPEG_AUDIO_MUTE         (V4L2_CID_MPEG_BASE+109)
  1000. #define V4L2_CID_MPEG_AUDIO_AAC_BITRATE        (V4L2_CID_MPEG_BASE+110)
  1001. #define V4L2_CID_MPEG_AUDIO_AC3_BITRATE        (V4L2_CID_MPEG_BASE+111)
  1002. enum v4l2_mpeg_audio_ac3_bitrate {
  1003.     V4L2_MPEG_AUDIO_AC3_BITRATE_32K  = 0,
  1004.     V4L2_MPEG_AUDIO_AC3_BITRATE_40K  = 1,
  1005.     V4L2_MPEG_AUDIO_AC3_BITRATE_48K  = 2,
  1006.     V4L2_MPEG_AUDIO_AC3_BITRATE_56K  = 3,
  1007.     V4L2_MPEG_AUDIO_AC3_BITRATE_64K  = 4,
  1008.     V4L2_MPEG_AUDIO_AC3_BITRATE_80K  = 5,
  1009.     V4L2_MPEG_AUDIO_AC3_BITRATE_96K  = 6,
  1010.     V4L2_MPEG_AUDIO_AC3_BITRATE_112K = 7,
  1011.     V4L2_MPEG_AUDIO_AC3_BITRATE_128K = 8,
  1012.     V4L2_MPEG_AUDIO_AC3_BITRATE_160K = 9,
  1013.     V4L2_MPEG_AUDIO_AC3_BITRATE_192K = 10,
  1014.     V4L2_MPEG_AUDIO_AC3_BITRATE_224K = 11,
  1015.     V4L2_MPEG_AUDIO_AC3_BITRATE_256K = 12,
  1016.     V4L2_MPEG_AUDIO_AC3_BITRATE_320K = 13,
  1017.     V4L2_MPEG_AUDIO_AC3_BITRATE_384K = 14,
  1018.     V4L2_MPEG_AUDIO_AC3_BITRATE_448K = 15,
  1019.     V4L2_MPEG_AUDIO_AC3_BITRATE_512K = 16,
  1020.     V4L2_MPEG_AUDIO_AC3_BITRATE_576K = 17,
  1021.     V4L2_MPEG_AUDIO_AC3_BITRATE_640K = 18,
  1022. };
  1023.  
  1024. /*  MPEG video */
  1025. #define V4L2_CID_MPEG_VIDEO_ENCODING         (V4L2_CID_MPEG_BASE+200)
  1026. enum v4l2_mpeg_video_encoding {
  1027.     V4L2_MPEG_VIDEO_ENCODING_MPEG_1     = 0,
  1028.     V4L2_MPEG_VIDEO_ENCODING_MPEG_2     = 1,
  1029.     V4L2_MPEG_VIDEO_ENCODING_MPEG_4_AVC = 2,
  1030. };
  1031. #define V4L2_CID_MPEG_VIDEO_ASPECT         (V4L2_CID_MPEG_BASE+201)
  1032. enum v4l2_mpeg_video_aspect {
  1033.     V4L2_MPEG_VIDEO_ASPECT_1x1     = 0,
  1034.     V4L2_MPEG_VIDEO_ASPECT_4x3     = 1,
  1035.     V4L2_MPEG_VIDEO_ASPECT_16x9    = 2,
  1036.     V4L2_MPEG_VIDEO_ASPECT_221x100 = 3,
  1037. };
  1038. #define V4L2_CID_MPEG_VIDEO_B_FRAMES         (V4L2_CID_MPEG_BASE+202)
  1039. #define V4L2_CID_MPEG_VIDEO_GOP_SIZE         (V4L2_CID_MPEG_BASE+203)
  1040. #define V4L2_CID_MPEG_VIDEO_GOP_CLOSURE     (V4L2_CID_MPEG_BASE+204)
  1041. #define V4L2_CID_MPEG_VIDEO_PULLDOWN         (V4L2_CID_MPEG_BASE+205)
  1042. #define V4L2_CID_MPEG_VIDEO_BITRATE_MODE     (V4L2_CID_MPEG_BASE+206)
  1043. enum v4l2_mpeg_video_bitrate_mode {
  1044.     V4L2_MPEG_VIDEO_BITRATE_MODE_VBR = 0,
  1045.     V4L2_MPEG_VIDEO_BITRATE_MODE_CBR = 1,
  1046. };
  1047. #define V4L2_CID_MPEG_VIDEO_BITRATE         (V4L2_CID_MPEG_BASE+207)
  1048. #define V4L2_CID_MPEG_VIDEO_BITRATE_PEAK     (V4L2_CID_MPEG_BASE+208)
  1049. #define V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION (V4L2_CID_MPEG_BASE+209)
  1050. #define V4L2_CID_MPEG_VIDEO_MUTE         (V4L2_CID_MPEG_BASE+210)
  1051. #define V4L2_CID_MPEG_VIDEO_MUTE_YUV         (V4L2_CID_MPEG_BASE+211)
  1052.  
  1053. /*  MPEG-class control IDs specific to the CX2584x driver as defined by V4L2 */
  1054. #define V4L2_CID_MPEG_CX2341X_BASE                 (V4L2_CTRL_CLASS_MPEG | 0x1000)
  1055. #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE     (V4L2_CID_MPEG_CX2341X_BASE+0)
  1056. enum v4l2_mpeg_cx2341x_video_spatial_filter_mode {
  1057.     V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL = 0,
  1058.     V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO   = 1,
  1059. };
  1060. #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER         (V4L2_CID_MPEG_CX2341X_BASE+1)
  1061. #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE     (V4L2_CID_MPEG_CX2341X_BASE+2)
  1062. enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type {
  1063.     V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF                  = 0,
  1064.     V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR               = 1,
  1065.     V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT              = 2,
  1066.     V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE      = 3,
  1067.     V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE = 4,
  1068. };
  1069. #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE     (V4L2_CID_MPEG_CX2341X_BASE+3)
  1070. enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type {
  1071.     V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF    = 0,
  1072.     V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR = 1,
  1073. };
  1074. #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE     (V4L2_CID_MPEG_CX2341X_BASE+4)
  1075. enum v4l2_mpeg_cx2341x_video_temporal_filter_mode {
  1076.     V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL = 0,
  1077.     V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO   = 1,
  1078. };
  1079. #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER         (V4L2_CID_MPEG_CX2341X_BASE+5)
  1080. #define V4L2_CID_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE         (V4L2_CID_MPEG_CX2341X_BASE+6)
  1081. enum v4l2_mpeg_cx2341x_video_median_filter_type {
  1082.     V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF      = 0,
  1083.     V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR      = 1,
  1084.     V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT     = 2,
  1085.     V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT = 3,
  1086.     V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG     = 4,
  1087. };
  1088. #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM     (V4L2_CID_MPEG_CX2341X_BASE+7)
  1089. #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP     (V4L2_CID_MPEG_CX2341X_BASE+8)
  1090. #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM    (V4L2_CID_MPEG_CX2341X_BASE+9)
  1091. #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP     (V4L2_CID_MPEG_CX2341X_BASE+10)
  1092. #define V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS     (V4L2_CID_MPEG_CX2341X_BASE+11)
  1093.  
  1094. /*  Camera class control IDs */
  1095. #define V4L2_CID_CAMERA_CLASS_BASE     (V4L2_CTRL_CLASS_CAMERA | 0x900)
  1096. #define V4L2_CID_CAMERA_CLASS         (V4L2_CTRL_CLASS_CAMERA | 1)
  1097.  
  1098. #define V4L2_CID_EXPOSURE_AUTO            (V4L2_CID_CAMERA_CLASS_BASE+1)
  1099. enum  v4l2_exposure_auto_type {
  1100.     V4L2_EXPOSURE_AUTO = 0,
  1101.     V4L2_EXPOSURE_MANUAL = 1,
  1102.     V4L2_EXPOSURE_SHUTTER_PRIORITY = 2,
  1103.     V4L2_EXPOSURE_APERTURE_PRIORITY = 3
  1104. };
  1105. #define V4L2_CID_EXPOSURE_ABSOLUTE        (V4L2_CID_CAMERA_CLASS_BASE+2)
  1106. #define V4L2_CID_EXPOSURE_AUTO_PRIORITY        (V4L2_CID_CAMERA_CLASS_BASE+3)
  1107.  
  1108. #define V4L2_CID_PAN_RELATIVE            (V4L2_CID_CAMERA_CLASS_BASE+4)
  1109. #define V4L2_CID_TILT_RELATIVE            (V4L2_CID_CAMERA_CLASS_BASE+5)
  1110. #define V4L2_CID_PAN_RESET            (V4L2_CID_CAMERA_CLASS_BASE+6)
  1111. #define V4L2_CID_TILT_RESET            (V4L2_CID_CAMERA_CLASS_BASE+7)
  1112.  
  1113. #define V4L2_CID_PAN_ABSOLUTE            (V4L2_CID_CAMERA_CLASS_BASE+8)
  1114. #define V4L2_CID_TILT_ABSOLUTE            (V4L2_CID_CAMERA_CLASS_BASE+9)
  1115.  
  1116. #define V4L2_CID_FOCUS_ABSOLUTE            (V4L2_CID_CAMERA_CLASS_BASE+10)
  1117. #define V4L2_CID_FOCUS_RELATIVE            (V4L2_CID_CAMERA_CLASS_BASE+11)
  1118. #define V4L2_CID_FOCUS_AUTO            (V4L2_CID_CAMERA_CLASS_BASE+12)
  1119.  
  1120. /*
  1121.  *    T U N I N G
  1122.  */
  1123. struct v4l2_tuner {
  1124.     __u32                   index;
  1125.     __u8            name[32];
  1126.     enum v4l2_tuner_type    type;
  1127.     __u32            capability;
  1128.     __u32            rangelow;
  1129.     __u32            rangehigh;
  1130.     __u32            rxsubchans;
  1131.     __u32            audmode;
  1132.     __s32            signal;
  1133.     __s32            afc;
  1134.     __u32            reserved[4];
  1135. };
  1136.  
  1137. struct v4l2_modulator {
  1138.     __u32            index;
  1139.     __u8            name[32];
  1140.     __u32            capability;
  1141.     __u32            rangelow;
  1142.     __u32            rangehigh;
  1143.     __u32            txsubchans;
  1144.     __u32            reserved[4];
  1145. };
  1146.  
  1147. /*  Flags for the 'capability' field */
  1148. #define V4L2_TUNER_CAP_LOW        0x0001
  1149. #define V4L2_TUNER_CAP_NORM        0x0002
  1150. #define V4L2_TUNER_CAP_STEREO        0x0010
  1151. #define V4L2_TUNER_CAP_LANG2        0x0020
  1152. #define V4L2_TUNER_CAP_SAP        0x0020
  1153. #define V4L2_TUNER_CAP_LANG1        0x0040
  1154.  
  1155. /*  Flags for the 'rxsubchans' field */
  1156. #define V4L2_TUNER_SUB_MONO        0x0001
  1157. #define V4L2_TUNER_SUB_STEREO        0x0002
  1158. #define V4L2_TUNER_SUB_LANG2        0x0004
  1159. #define V4L2_TUNER_SUB_SAP        0x0004
  1160. #define V4L2_TUNER_SUB_LANG1        0x0008
  1161.  
  1162. /*  Values for the 'audmode' field */
  1163. #define V4L2_TUNER_MODE_MONO        0x0000
  1164. #define V4L2_TUNER_MODE_STEREO        0x0001
  1165. #define V4L2_TUNER_MODE_LANG2        0x0002
  1166. #define V4L2_TUNER_MODE_SAP        0x0002
  1167. #define V4L2_TUNER_MODE_LANG1        0x0003
  1168. #define V4L2_TUNER_MODE_LANG1_LANG2    0x0004
  1169.  
  1170. struct v4l2_frequency {
  1171.     __u32              tuner;
  1172.     enum v4l2_tuner_type  type;
  1173.     __u32              frequency;
  1174.     __u32              reserved[8];
  1175. };
  1176.  
  1177. struct v4l2_hw_freq_seek {
  1178.     __u32              tuner;
  1179.     enum v4l2_tuner_type  type;
  1180.     __u32              seek_upward;
  1181.     __u32              wrap_around;
  1182.     __u32              reserved[8];
  1183. };
  1184.  
  1185. /*
  1186.  *    A U D I O
  1187.  */
  1188. struct v4l2_audio {
  1189.     __u32    index;
  1190.     __u8    name[32];
  1191.     __u32    capability;
  1192.     __u32    mode;
  1193.     __u32    reserved[2];
  1194. };
  1195.  
  1196. /*  Flags for the 'capability' field */
  1197. #define V4L2_AUDCAP_STEREO        0x00001
  1198. #define V4L2_AUDCAP_AVL            0x00002
  1199.  
  1200. /*  Flags for the 'mode' field */
  1201. #define V4L2_AUDMODE_AVL        0x00001
  1202.  
  1203. struct v4l2_audioout {
  1204.     __u32    index;
  1205.     __u8    name[32];
  1206.     __u32    capability;
  1207.     __u32    mode;
  1208.     __u32    reserved[2];
  1209. };
  1210.  
  1211. /*
  1212.  *    M P E G   S E R V I C E S
  1213.  *
  1214.  *    NOTE: EXPERIMENTAL API
  1215.  */
  1216. #if 1
  1217. #define V4L2_ENC_IDX_FRAME_I    (0)
  1218. #define V4L2_ENC_IDX_FRAME_P    (1)
  1219. #define V4L2_ENC_IDX_FRAME_B    (2)
  1220. #define V4L2_ENC_IDX_FRAME_MASK (0xf)
  1221.  
  1222. struct v4l2_enc_idx_entry {
  1223.     __u64 offset;
  1224.     __u64 pts;
  1225.     __u32 length;
  1226.     __u32 flags;
  1227.     __u32 reserved[2];
  1228. };
  1229.  
  1230. #define V4L2_ENC_IDX_ENTRIES (64)
  1231. struct v4l2_enc_idx {
  1232.     __u32 entries;
  1233.     __u32 entries_cap;
  1234.     __u32 reserved[4];
  1235.     struct v4l2_enc_idx_entry entry[V4L2_ENC_IDX_ENTRIES];
  1236. };
  1237.  
  1238.  
  1239. #define V4L2_ENC_CMD_START      (0)
  1240. #define V4L2_ENC_CMD_STOP       (1)
  1241. #define V4L2_ENC_CMD_PAUSE      (2)
  1242. #define V4L2_ENC_CMD_RESUME     (3)
  1243.  
  1244. /* Flags for V4L2_ENC_CMD_STOP */
  1245. #define V4L2_ENC_CMD_STOP_AT_GOP_END    (1 << 0)
  1246.  
  1247. struct v4l2_encoder_cmd {
  1248.     __u32 cmd;
  1249.     __u32 flags;
  1250.     union {
  1251.         struct {
  1252.             __u32 data[8];
  1253.         } raw;
  1254.     };
  1255. };
  1256.  
  1257. #endif
  1258.  
  1259.  
  1260. /*
  1261.  *    D A T A   S E R V I C E S   ( V B I )
  1262.  *
  1263.  *    Data services API by Michael Schimek
  1264.  */
  1265.  
  1266. /* Raw VBI */
  1267. struct v4l2_vbi_format {
  1268.     __u32    sampling_rate;        /* in 1 Hz */
  1269.     __u32    offset;
  1270.     __u32    samples_per_line;
  1271.     __u32    sample_format;        /* V4L2_PIX_FMT_* */
  1272.     __s32    start[2];
  1273.     __u32    count[2];
  1274.     __u32    flags;            /* V4L2_VBI_* */
  1275.     __u32    reserved[2];        /* must be zero */
  1276. };
  1277.  
  1278. /*  VBI flags  */
  1279. #define V4L2_VBI_UNSYNC        (1 << 0)
  1280. #define V4L2_VBI_INTERLACED    (1 << 1)
  1281.  
  1282. /* Sliced VBI
  1283.  *
  1284.  *    This implements is a proposal V4L2 API to allow SLICED VBI
  1285.  * required for some hardware encoders. It should change without
  1286.  * notice in the definitive implementation.
  1287.  */
  1288.  
  1289. struct v4l2_sliced_vbi_format {
  1290.     __u16   service_set;
  1291.     /* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
  1292.        service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
  1293.                  (equals frame lines 313-336 for 625 line video
  1294.                   standards, 263-286 for 525 line standards) */
  1295.     __u16   service_lines[2][24];
  1296.     __u32   io_size;
  1297.     __u32   reserved[2];            /* must be zero */
  1298. };
  1299.  
  1300. /* Teletext World System Teletext
  1301.    (WST), defined on ITU-R BT.653-2 */
  1302. #define V4L2_SLICED_TELETEXT_B          (0x0001)
  1303. /* Video Program System, defined on ETS 300 231*/
  1304. #define V4L2_SLICED_VPS                 (0x0400)
  1305. /* Closed Caption, defined on EIA-608 */
  1306. #define V4L2_SLICED_CAPTION_525         (0x1000)
  1307. /* Wide Screen System, defined on ITU-R BT1119.1 */
  1308. #define V4L2_SLICED_WSS_625             (0x4000)
  1309.  
  1310. #define V4L2_SLICED_VBI_525             (V4L2_SLICED_CAPTION_525)
  1311. #define V4L2_SLICED_VBI_625             (V4L2_SLICED_TELETEXT_B | V4L2_SLICED_VPS | V4L2_SLICED_WSS_625)
  1312.  
  1313. struct v4l2_sliced_vbi_cap {
  1314.     __u16   service_set;
  1315.     /* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
  1316.        service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
  1317.                  (equals frame lines 313-336 for 625 line video
  1318.                   standards, 263-286 for 525 line standards) */
  1319.     __u16   service_lines[2][24];
  1320.     enum v4l2_buf_type type;
  1321.     __u32   reserved[3];    /* must be 0 */
  1322. };
  1323.  
  1324. struct v4l2_sliced_vbi_data {
  1325.     __u32   id;
  1326.     __u32   field;          /* 0: first field, 1: second field */
  1327.     __u32   line;           /* 1-23 */
  1328.     __u32   reserved;       /* must be 0 */
  1329.     __u8    data[48];
  1330. };
  1331.  
  1332. /*
  1333.  *    A G G R E G A T E   S T R U C T U R E S
  1334.  */
  1335.  
  1336. /*    Stream data format
  1337.  */
  1338. struct v4l2_format {
  1339.     enum v4l2_buf_type type;
  1340.     union {
  1341.         struct v4l2_pix_format        pix;     /* V4L2_BUF_TYPE_VIDEO_CAPTURE */
  1342.         struct v4l2_window        win;     /* V4L2_BUF_TYPE_VIDEO_OVERLAY */
  1343.         struct v4l2_vbi_format        vbi;     /* V4L2_BUF_TYPE_VBI_CAPTURE */
  1344.         struct v4l2_sliced_vbi_format    sliced;  /* V4L2_BUF_TYPE_SLICED_VBI_CAPTURE */
  1345.         __u8    raw_data[200];                   /* user-defined */
  1346.     } fmt;
  1347. };
  1348.  
  1349.  
  1350. /*    Stream type-dependent parameters
  1351.  */
  1352. struct v4l2_streamparm {
  1353.     enum v4l2_buf_type type;
  1354.     union {
  1355.         struct v4l2_captureparm    capture;
  1356.         struct v4l2_outputparm    output;
  1357.         __u8    raw_data[200];  /* user-defined */
  1358.     } parm;
  1359. };
  1360.  
  1361. /*
  1362.  *    A D V A N C E D   D E B U G G I N G
  1363.  *
  1364.  *    NOTE: EXPERIMENTAL API
  1365.  */
  1366.  
  1367. /* VIDIOC_DBG_G_REGISTER and VIDIOC_DBG_S_REGISTER */
  1368.  
  1369. #define V4L2_CHIP_MATCH_HOST       0  /* Match against chip ID on host (0 for the host) */
  1370. #define V4L2_CHIP_MATCH_I2C_DRIVER 1  /* Match against I2C driver ID */
  1371. #define V4L2_CHIP_MATCH_I2C_ADDR   2  /* Match against I2C 7-bit address */
  1372.  
  1373. struct v4l2_register {
  1374.     __u32 match_type; /* Match type */
  1375.     __u32 match_chip; /* Match this chip, meaning determined by match_type */
  1376.     __u64 reg;
  1377.     __u64 val;
  1378. };
  1379.  
  1380. /* VIDIOC_G_CHIP_IDENT */
  1381. struct v4l2_chip_ident {
  1382.     __u32 match_type;  /* Match type */
  1383.     __u32 match_chip;  /* Match this chip, meaning determined by match_type */
  1384.     __u32 ident;       /* chip identifier as specified in <media/v4l2-chip-ident.h> */
  1385.     __u32 revision;    /* chip revision, chip specific */
  1386. };
  1387.  
  1388. /*
  1389.  *    I O C T L   C O D E S   F O R   V I D E O   D E V I C E S
  1390.  *
  1391.  */
  1392. #define VIDIOC_QUERYCAP         _IOR('V',  0, struct v4l2_capability)
  1393. #define VIDIOC_RESERVED          _IO('V',  1)
  1394. #define VIDIOC_ENUM_FMT         _IOWR('V',  2, struct v4l2_fmtdesc)
  1395. #define VIDIOC_G_FMT        _IOWR('V',  4, struct v4l2_format)
  1396. #define VIDIOC_S_FMT        _IOWR('V',  5, struct v4l2_format)
  1397. #define VIDIOC_REQBUFS        _IOWR('V',  8, struct v4l2_requestbuffers)
  1398. #define VIDIOC_QUERYBUF        _IOWR('V',  9, struct v4l2_buffer)
  1399. #define VIDIOC_G_FBUF         _IOR('V', 10, struct v4l2_framebuffer)
  1400. #define VIDIOC_S_FBUF         _IOW('V', 11, struct v4l2_framebuffer)
  1401. #define VIDIOC_OVERLAY         _IOW('V', 14, int)
  1402. #define VIDIOC_QBUF        _IOWR('V', 15, struct v4l2_buffer)
  1403. #define VIDIOC_DQBUF        _IOWR('V', 17, struct v4l2_buffer)
  1404. #define VIDIOC_STREAMON         _IOW('V', 18, int)
  1405. #define VIDIOC_STREAMOFF     _IOW('V', 19, int)
  1406. #define VIDIOC_G_PARM        _IOWR('V', 21, struct v4l2_streamparm)
  1407. #define VIDIOC_S_PARM        _IOWR('V', 22, struct v4l2_streamparm)
  1408. #define VIDIOC_G_STD         _IOR('V', 23, v4l2_std_id)
  1409. #define VIDIOC_S_STD         _IOW('V', 24, v4l2_std_id)
  1410. #define VIDIOC_ENUMSTD        _IOWR('V', 25, struct v4l2_standard)
  1411. #define VIDIOC_ENUMINPUT    _IOWR('V', 26, struct v4l2_input)
  1412. #define VIDIOC_G_CTRL        _IOWR('V', 27, struct v4l2_control)
  1413. #define VIDIOC_S_CTRL        _IOWR('V', 28, struct v4l2_control)
  1414. #define VIDIOC_G_TUNER        _IOWR('V', 29, struct v4l2_tuner)
  1415. #define VIDIOC_S_TUNER         _IOW('V', 30, struct v4l2_tuner)
  1416. #define VIDIOC_G_AUDIO         _IOR('V', 33, struct v4l2_audio)
  1417. #define VIDIOC_S_AUDIO         _IOW('V', 34, struct v4l2_audio)
  1418. #define VIDIOC_QUERYCTRL    _IOWR('V', 36, struct v4l2_queryctrl)
  1419. #define VIDIOC_QUERYMENU    _IOWR('V', 37, struct v4l2_querymenu)
  1420. #define VIDIOC_G_INPUT         _IOR('V', 38, int)
  1421. #define VIDIOC_S_INPUT        _IOWR('V', 39, int)
  1422. #define VIDIOC_G_OUTPUT         _IOR('V', 46, int)
  1423. #define VIDIOC_S_OUTPUT        _IOWR('V', 47, int)
  1424. #define VIDIOC_ENUMOUTPUT    _IOWR('V', 48, struct v4l2_output)
  1425. #define VIDIOC_G_AUDOUT         _IOR('V', 49, struct v4l2_audioout)
  1426. #define VIDIOC_S_AUDOUT         _IOW('V', 50, struct v4l2_audioout)
  1427. #define VIDIOC_G_MODULATOR    _IOWR('V', 54, struct v4l2_modulator)
  1428. #define VIDIOC_S_MODULATOR     _IOW('V', 55, struct v4l2_modulator)
  1429. #define VIDIOC_G_FREQUENCY    _IOWR('V', 56, struct v4l2_frequency)
  1430. #define VIDIOC_S_FREQUENCY     _IOW('V', 57, struct v4l2_frequency)
  1431. #define VIDIOC_CROPCAP        _IOWR('V', 58, struct v4l2_cropcap)
  1432. #define VIDIOC_G_CROP        _IOWR('V', 59, struct v4l2_crop)
  1433. #define VIDIOC_S_CROP         _IOW('V', 60, struct v4l2_crop)
  1434. #define VIDIOC_G_JPEGCOMP     _IOR('V', 61, struct v4l2_jpegcompression)
  1435. #define VIDIOC_S_JPEGCOMP     _IOW('V', 62, struct v4l2_jpegcompression)
  1436. #define VIDIOC_QUERYSTD           _IOR('V', 63, v4l2_std_id)
  1437. #define VIDIOC_TRY_FMT          _IOWR('V', 64, struct v4l2_format)
  1438. #define VIDIOC_ENUMAUDIO    _IOWR('V', 65, struct v4l2_audio)
  1439. #define VIDIOC_ENUMAUDOUT    _IOWR('V', 66, struct v4l2_audioout)
  1440. #define VIDIOC_G_PRIORITY        _IOR('V', 67, enum v4l2_priority)
  1441. #define VIDIOC_S_PRIORITY        _IOW('V', 68, enum v4l2_priority)
  1442. #define VIDIOC_G_SLICED_VBI_CAP _IOWR('V', 69, struct v4l2_sliced_vbi_cap)
  1443. #define VIDIOC_LOG_STATUS         _IO('V', 70)
  1444. #define VIDIOC_G_EXT_CTRLS    _IOWR('V', 71, struct v4l2_ext_controls)
  1445. #define VIDIOC_S_EXT_CTRLS    _IOWR('V', 72, struct v4l2_ext_controls)
  1446. #define VIDIOC_TRY_EXT_CTRLS    _IOWR('V', 73, struct v4l2_ext_controls)
  1447. #if 1
  1448. #define VIDIOC_ENUM_FRAMESIZES    _IOWR('V', 74, struct v4l2_frmsizeenum)
  1449. #define VIDIOC_ENUM_FRAMEINTERVALS _IOWR('V', 75, struct v4l2_frmivalenum)
  1450. #define VIDIOC_G_ENC_INDEX       _IOR('V', 76, struct v4l2_enc_idx)
  1451. #define VIDIOC_ENCODER_CMD      _IOWR('V', 77, struct v4l2_encoder_cmd)
  1452. #define VIDIOC_TRY_ENCODER_CMD  _IOWR('V', 78, struct v4l2_encoder_cmd)
  1453.  
  1454. /* Experimental, only implemented if CONFIG_VIDEO_ADV_DEBUG is defined */
  1455. #define    VIDIOC_DBG_S_REGISTER      _IOW('V', 79, struct v4l2_register)
  1456. #define    VIDIOC_DBG_G_REGISTER     _IOWR('V', 80, struct v4l2_register)
  1457.  
  1458. #define VIDIOC_G_CHIP_IDENT     _IOWR('V', 81, struct v4l2_chip_ident)
  1459. #endif
  1460. #define VIDIOC_S_HW_FREQ_SEEK     _IOW('V', 82, struct v4l2_hw_freq_seek)
  1461.  
  1462. #ifdef __OLD_VIDIOC_
  1463. /* for compatibility, will go away some day */
  1464. #define VIDIOC_OVERLAY_OLD         _IOWR('V', 14, int)
  1465. #define VIDIOC_S_PARM_OLD           _IOW('V', 22, struct v4l2_streamparm)
  1466. #define VIDIOC_S_CTRL_OLD           _IOW('V', 28, struct v4l2_control)
  1467. #define VIDIOC_G_AUDIO_OLD         _IOWR('V', 33, struct v4l2_audio)
  1468. #define VIDIOC_G_AUDOUT_OLD        _IOWR('V', 49, struct v4l2_audioout)
  1469. #define VIDIOC_CROPCAP_OLD          _IOR('V', 58, struct v4l2_cropcap)
  1470. #endif
  1471.  
  1472. #define BASE_VIDIOC_PRIVATE    192        /* 192-255 are private */
  1473.  
  1474. #endif /* __LINUX_VIDEODEV2_H */
  1475.